
*************************************************************************
* Author:		CG, JU
* File name:		ReadMe.txt
* Institution:		Columbia, Johns Hopkins	
* File Date: 		July 25, 2018
* Publication title:	LPG as a Clean Cooking Fuel: Adoption, Use, and Impact in India
* Journal:		Energy Policy
* File purpose:		Read me for the replication package 
*************************************************************************

Table of contents:
1. Introduction
2. Replication procedure

*************************************************************************
*	1. Introduction
*************************************************************************

This file is the ReadMe.txt for the replication package of our Energy Policy article. The zip file contains the following files:

- ReadMe.txt. This file.

- Codebook.pdf. A pdf file that contains the description of all variables as well as a presentation of the most important identifiers. 

- HouseholdVillage.pdf: a pdf that contains the questionnaire for both the household- and the village-level data. 

- RawDataHH.dta: a Stata (version 12) dataset containing the raw data at the household level. These data underly all analyses and results.

- ReplicationCode.R: an R file that contains code for carrying out all the analyses reported in the manuscript and the supplementary material. 

- Sampling_ACCESS.pdf: a pdf that describes the sampling strategy used to select districts, villages, and households. 

-2011_Dist shape files: A set of shape files containing geographic spatial information for Indian districts based on the 2011 census. A ReadMe for the source of the shape files is available in this folder.

-INDIA shape files: A set of shape files containing geographic spatial information for Indian states. A ReadMe for the source of the shape files is available in this folder.


*************************************************************************
*	2. Replication procedure
*************************************************************************

(1) Download the zip file and open it.

(2) ReplicationCode.R. 

-The first lines of code allow the user to install and call R packages needed.
-The code is organized as follows:

i) Code Set Up: Load required libraries, develop indicator variables, create data subsets for secondary analyses.
ii) Development of tables required for figures: These are the tables that underly figures presented in the main text of the manuscript and supporting information, but are not themselves presented in the manuscript. 
iii) Development of figures in manuscript: Here the figures shown in the manuscript are produced (largely based on tables created in (ii)).
iv) Development of figures in supporting information: Here figures shown in supporting information are produced. 

** Note: File path to the Dataverse_Files folder must be set in Lines 48, 893, and 896.
** Note: The production of the maps will take several minutes.
** Note: Figures will be produced and displayed within R.

(3) If you don’t have any reason to change the coding of any variable, then you can directly work with RawDataHH.dta.
